home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / prog / dnalib59.arj / NONAME.TXT < prev    next >
Text File  |  1994-02-23  |  9KB  |  193 lines
  1. '┌─────────────────────────────────────────────────────────────────────┐
  2. '│                                                                     │░░
  3. '│                         DNALIB Version 5.9                          │░░
  4. '│                 CopyRight 1993 by FREEBEE Software                  │░░
  5. '│                                                                     │░░
  6. '│                      For PowerBASIC Version 3.*                     │░░
  7. '│                                                                     │░░
  8. '└─────────────────────────────────────────────────────────────────────┘░░
  9. '  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  10.  
  11.  
  12.         DnaLib is totally free of charge for you to use or abuse, as you
  13. see fit.  You have the source code, so look it over before you run it !!!
  14. If your Computer Dies, or your Dog or Cat gets pregnant and your spouse
  15. leaves you "It's your fault and NOT MINE".
  16.  
  17.         I would like to start a register of users, so that I will know that
  18. all this work is not invain, so if you like or find DnaLib useful send me a
  19. postcard or a fax, at the address on the opening screen, DONT SEND MONEY !
  20. If you think DnaLib has some value then make a donation to your favorite
  21. charity.
  22.  
  23.         In an attempt to get some more response I shall put together a 
  24. manual and send it at my cost to whoever, either sends me a fax or a post
  25. card, or leaves me a message with where to send it on BASNET(PowerBASIC)
  26. echo, or at PowerBASIC tech support BBS see the ABOUT PowerBASIC choice
  27. in the online HELP in PowerBASIC IDE for phone number.
  28.  
  29.         NEW Lots of changes! and some new routines that I have written for
  30. the DNA-Write project, I hope to have the DNA-Write project finished by XMAS
  31. so keep whatching.
  32.  
  33.         NEW this release sees the full implementation of DNAWrite which is
  34. a version of PBWrite by Erik Olson and the routines from the DNA Library
  35. and a few gaps filled in, I would really appreciate some feed back on this
  36. one as it has taken a good deal of time and DEBUGGING to get it this far,
  37. so if you find bugs let me know about them !
  38.  
  39.         THINGS still to do, the mark text with mouse is not ready yet and
  40. if anyone has any ideas for this please let me know. Once I have this 
  41. routine figured, the Delete and Copy routines are already here.
  42.   I plan to add somesort of activity gauge while the file is loading ie
  43. like the install routine on the PowerBASIC distribution disks, and I am also
  44. playing around with Erik's CALC.BAS from the GAP library, would anyone out
  45. there like me to include a mouse or keyboard driven calculator to DNAWrite
  46. so thats all folks.
  47.  
  48.         IMMPORTANT I have added another parameter to Horizontal Menu it is
  49. called HiLight% and it is so you can switch the hotkeys on and off, look at
  50. the source to DNAWrite to see how I've done it.
  51.  
  52.   1) EDITBOX is a combination of several routines, and if you run the file
  53. DNAWRITE.EXE you will see it in action from the (S)earch and then (F)ind
  54. menu selections.
  55.  
  56.   2) DBLBOX is as above but with two Line Edits. see the (S)earch and then
  57. (R)eplace menu selections. 
  58.  
  59.   3) DIRBOX is a routine to display files and directories and a line edit to
  60. edit path or file display, by entering a path and ie. *.Com    DIRBOX will 
  61. display only the COM files in that directory, DIRBOX has complete mouse 
  62. support, scroll bars, etc.
  63.  
  64.   4) SAVEAS is a routine for returning a selectable path and file name.
  65. it will cut a paste the current file name on to a selectable path for you.
  66.  
  67.   5)  LOCKS will display a NUM & CAPS on a line and column of your choice.
  68.  
  69.   6) YESNO is a FUNCTION that allows you to place a question on screen and
  70. get a TRUE or FALSE answer so you can ie. 
  71.  
  72.                 IF YesNo%(parameters) THEN
  73.                   DoSomething
  74.                 ELSE
  75.                   DoSomethingElse
  76.                 END IF
  77.  
  78.   7) MAYBE is a subroutine to display a question and return an answer other
  79. than yes or no, yes is still 1 or %TRUE and no is 0 or %FALSE but C or c or
  80. Esc is 2 so you can use it like this ie.
  81.  
  82.                 MAYBE(parameters)
  83.                   SELECT CASE Answer%
  84.                          CASE 0
  85.                            %FALSE statments
  86.                          CASE 1
  87.                            %TRUE statments
  88.                          CASE 2
  89.                            others statments
  90.                   END SELECT
  91.  
  92.         LINEEDIT has been changed ! it now has an exit with the mouse and a
  93. fall through by setting Editkey% to 255, (this is how I am keeping the name
  94. and path current in DIRBOX), If the exit was with the mouse then Editkey will
  95. have a value of -255 and the row and column values of the position the mouse
  96. was clicked will be in MouseRow% and MouseCol%, you then have to build a 
  97. SELECT CASE around these values (again this is how DIRBOX works) ie.
  98.  
  99.                 LINEEDIT(parameters)
  100.                   IF EditKey% = -255 THEN
  101.                     SELECT CASE MRow%
  102.                            CASE 1
  103.                              SELECT CASE MCol%
  104.                                     CASE 1 TO 80
  105.                                       do something on the first row
  106.                              END SELECT
  107.                     END SELECT
  108.                   ELSE
  109.                     SELECT CASE EditKey%
  110.                            CASE 255
  111.                              fall through
  112.                            CASE 13
  113.                              do something with enter key
  114.                     END SELECT
  115.                   END IF
  116.  
  117. I shall build some data entry screens in the next version of DNALIB as a
  118. demo of how to implement these features.
  119.  
  120.         IMPORTANT I have changed the FGround, BGround variables to Attributes,
  121. so you have to pass a pair of colors now (I did this because there is a limit
  122. of 16 parameters that you can pass to a SUB).
  123.  
  124.         NEW Full Mouse support, all you have to do is add one line to your 
  125. main program ie.
  126.  
  127.                 IF MouseThere% THEN  Mouse% = 1 (or %TRUE)
  128.  
  129. There are a couple of other routines which are not in the demo but you have
  130. the source.
  131.  
  132.         MakeByte() will make an Attribute for you from FGround and BGround.
  133.     
  134.                 MakeByte Attribute%, 15(BrightWhite), 1(Blue)
  135.                 Attribute% = 31  
  136.  
  137.         CalcByte() will perform the reverse of MakeByte
  138.                 CalcByte 31,FGround%,BGround%
  139.                 FGround% = 15 BGround% = 1
  140.  
  141. you could also use these routines when you call an intrupt that
  142. returns a Hi,Low Byte.
  143.  
  144.         CheckBits is very simple but useful if you want to check more than
  145. one bit etc.
  146.  
  147.         ScreenPlus will return a word that is closest to the Row%, Col% you
  148. pass it (maybe the start of a spell checker).
  149.  
  150. If you are reading this from the (N)ew menu choice and have not run HELP.BAT
  151. exit and do it now, doing so will give you a much better feel for the "New"
  152. Help system.  All "HELP.BAT" does is copy DUMMY.HLP to all the different menu
  153. Names, This is just a way of keeping the size of the distribution ZIP.  to a
  154. minimum.
  155.  
  156. NEW in this release the HELP system, the centre of which is a modified form
  157. of BROWSE.BAS from the GAP Library and included with the kind permission of
  158. Eric Olson (the original author).  By pressing F1 from any menu choice the
  159. menu system removes any spaces or "@" (hot key marker) and builds a file name
  160. from the first eight characters or less, "Save As" would become "SAVEAS.HLP".
  161. It then calls BROWSE and BROWSE checks to see if the file is in the current
  162. directory, if the file is there BROWSE saves a portion of the screen, and
  163. pops a window on screen and displays the file.  Not Hypertext but context
  164. sensitive.
  165.  
  166. NEW in this release SCROLBOX has been greatly enhanced, you can use the space
  167. bar to TAG and UNTAG files or anything else you display with SCROLBOX.
  168. It also contains a SEARCH on the first letter of any displayed choices, it
  169. will search forward from the scroll bar and find the next match, if there is
  170. no match it will go to the beginning and search towards the scroll bar, there
  171. is also a side bar to show how far through the choices you are.
  172.  
  173. NEW in this release TYPWRITE and NOISE, TYPWRITE will simulate a typewriter
  174. in sound and speed and may be useful for a NAG screen or a presentation demo
  175. etc.  NOISE is a collection of clicks, chirps, phasers, etc.
  176.  
  177.                                 BUG LIST
  178.                                 ~~~~~~~~
  179. If you have DnaLib30.* then there was a bug in the ScrolBox search routine,
  180. but only if the mouse was on the window,  I have made the mouse routines in
  181. ScrolBox a bit faster.  And added the cancel window box [■], if you are using
  182. Titles to the windows, the routines check to see if the box will fit on the
  183. top leftside of the window, if there is no space for it, it will be placed
  184. on the bottom leftside of the window.  Also if there is no mouse the boxes
  185. and scroll bars are not displayed.
  186.  
  187. There was a bug in the save and restore routines not a biggee but a bug all
  188. the same, it was caused by the use of a (;) as a delimiting character in the
  189. string I was storing the saved portion of the screen to, it would cause 
  190. strange colours and characters to appear I have changed the character to 
  191. CHR$(255) which should solve the problem but this could be any character 
  192. you like.
  193.